From fafc106898db0884f226a3fe1fd4d3eaa2a473b7 Mon Sep 17 00:00:00 2001
From: robertl <robertl>
Date: Sun, 17 Aug 2008 22:17:48 +0000
Subject: [PATCH] Add forgotten doc for height filter.

---
 xmldoc/filters/height.xml                    | 22 ++++++++++++++++++++
 xmldoc/filters/options/height-add.xml        |  6 ++++++
 xmldoc/filters/options/height-wgs84tomsl.xml |  6 ++++++
 3 files changed, 34 insertions(+)
 create mode 100644 xmldoc/filters/height.xml
 create mode 100644 xmldoc/filters/options/height-add.xml
 create mode 100644 xmldoc/filters/options/height-wgs84tomsl.xml

diff --git a/xmldoc/filters/height.xml b/xmldoc/filters/height.xml
new file mode 100644
index 000000000..f37411cbf
--- /dev/null
+++ b/xmldoc/filters/height.xml
@@ -0,0 +1,22 @@
+<para> 
+The height filter allows the correction of altitude values.
+
+At least one popular gps logger does store the ellipsoidal height (sum of the height above mean see level and the height of the geoid above the WGS84 ellipsoid) instead of the height above sea level, as it can be found on maps. 
+
+The height filter allows for the correction of these altitude values. This filter supports two options:   
+
+<option>wgs84tomsl</option> and <option>add</option>.  
+At least one of these options is required, both can be combined.  
+</para>
+<example id="height_wgs84tomsl">
+  <title> This option subtracts the WGS84 geoid height from every altitude. For GPS receivers like the iBlue747 the result is the height above mean see level.</title>
+  <para><userinput> gpsbabel -i gpx -f in.gpx -x height,wgs84tomsl -o gpx -F out.gpx</userinput></para>
+  <para>The coordinates and altitude vales must be based an the WGS84 ellipsoid for this option to produce sensible results</para>
+</example>
+<example id="height_add">
+  <title> This options adds a constant value to every altitude.</title>
+  <para><userinput> gpsbabel -i gpx -f in.gpx -x height,add=10.2f -o gpx -F out.gpx</userinput></para>
+  <para>You can specify negative numbers to subtract the value. If no unit is specified meters are assumed. For feet you can attach an "f" to the value.</para>
+</example>
+
+      
diff --git a/xmldoc/filters/options/height-add.xml b/xmldoc/filters/options/height-add.xml
new file mode 100644
index 000000000..60f44f0dd
--- /dev/null
+++ b/xmldoc/filters/options/height-add.xml
@@ -0,0 +1,6 @@
+<para>
+Adds a constant value to every altitude. You can specify negative numbers to subtract the value.
+</para>
+<para>
+If no unit is specified, (m)eters are assumed. You can override this by attaching a "f" for feet to the number.
+</para>
diff --git a/xmldoc/filters/options/height-wgs84tomsl.xml b/xmldoc/filters/options/height-wgs84tomsl.xml
new file mode 100644
index 000000000..771bb3265
--- /dev/null
+++ b/xmldoc/filters/options/height-wgs84tomsl.xml
@@ -0,0 +1,6 @@
+<para>
+  Subtracts the WGS84 geoid height from every altitude.
+</para>
+<para>
+  For GPS receivers like the iBlue747 this corrects the logged altitudes to height above mean sea level.
+</para>
-- 
2.30.2